.. _ribbon_detect_joints:

Detect Joints
==========================

.. |DETECT_JOINTS| image:: ../images/en/DetectJoints.png

|DETECT_JOINTS| **Detect Joints** is a tool that can automatically detect joints from the geometry in the CAD model to save modeling time. It essentially detects the *peg in a hole* scenario.

At the moment the only joints that are detectable by the tool are :ref:`hinge_joint`, :ref:`cylindrical_joint`, :ref: `prismatic_joint` and :ref:`lock_joint` i.e., cylinders inside cylindrical holes.

-------
Usage
-------

**Detect joints** will search in the current selection, or in the whole model if nothing is selected.

1. Select the |DETECT_JOINTS| **Detect Joints** tool in the ribbon menu  
   (the tool will now search the model for potential joints). 

2. All potential joints will be highlighted in gray.  

.. image:: ../images/en/DetectJointExample.png

3. Select each joint individually (CTRL-click) or all the joints (CTRL-A) and choose which joint type will be used.  

.. image:: ../images/en/DetectJointExample2.png

--------------------------------
Options
--------------------------------

You can specify the various options for locating potential joints in the options tab for :ref:`detect_joints_options`.

.. ATTENTION::
  If there are joints that are not detected by the tool, it could be that the cylinders/pins are not 100% circular; or that they are misaligned or too far apart.